home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / netmail / gmsg415.zip / GENMSG.DOC < prev    next >
Text File  |  1994-07-30  |  13KB  |  259 lines
  1.              GenMsg Copyright (c) 1992, 1993, 1994  G. K. Pace
  2.                                 Version 4.15
  3.                                July 30, 1994
  4.  
  5.  DESCRIPTION:
  6.      GenMsg is a FidoNet compatable message  viewer/editing system  designed 
  7.  for systems using the *.msg format  of message  storage.  It  is a  "shell" 
  8.  type system. There isn't a text-editor  built in,  you use  GenMsg to  call 
  9.  your favorite Ascii Text editor (I use VDE a very good editor) to edit  the 
  10.  text.  GenMsg then formats  it to  FidoNet specifications  for the  type of 
  11.  message it is.  GenMsg can also shell to other utilities...  Such as Pretty 
  12.  Good Privacy (PGP) a "free-ware" Public Key encryption system.  PGP  can be 
  13.  called  by  GenMsg  for  decoding encrypted  messages, and  for encrypting, 
  14.  signing, or clear-text signing of messages.
  15.  
  16.      GenMsg  was  the  first  FidoNet message  editor available  which would 
  17.  interface PGP  to Fidonet  messages.  Today  it is  the most  up-to-date of 
  18.  those which have come since... <grin>
  19.  
  20.  FEATURES:
  21.      GenMsg supports the D'Bridge mailer, and  can be  setup to  replace the 
  22.  Internal Editor, or as an alternate Editor to be used as needed.   Refer to 
  23.  the enclosed DBRIDGE.TXT file for information on configuring  for use  with 
  24.  D'Bridge.
  25.  
  26.      GenMsg  supports  the SecureMail  principal, and  can be  configured to 
  27.  refuse to show the  contents of  in-transit messages...   for you  "snoopy" 
  28.  types, you  can disable  this and  view anything  on your  system... <grin> 
  29.  Registered versions also include  the function  for returning  E-Mail which 
  30.  cannot be  delivered (for  those who  Route Mail  for others)  in a  secure 
  31.  fashion... the text of message is not viewed when using this function.
  32.  
  33.      GenMsg  supports  the  use  of  Pretty  Good Privacy  (PGP) for  use in 
  34.  handling  encrypted,  ascii-armor,  and  clear-text  signatures  in FidoNet 
  35.  messages.
  36.  
  37.      GenMsg is designed to utilize the Ascii-text editor of your  choice, so 
  38.  that the editing commands can be as you prefer.  I  suggest use  of VDE,  a 
  39.  fully configurable editor which is very one of the best I've seen  for this 
  40.  purpose!  The enclosed file GMSG-VDE.ZIP contains some configuration  files 
  41.  for VDE, which setup VDE for use with GenMsg.  Refer to the Readme.txt file 
  42.  in this archive.
  43.  
  44.      GenMsg  can  handle  messages  of upto  64K in  length. (Non-registered 
  45.  versions, 32K)
  46.  
  47.      GenMsg provides  full INTL  and POINT  addressing.  Default  addressing 
  48.  style allows shortcuts in address entry.  For example,  to address  to node 
  49.  12 in  your net,  just enter  12 when  prompted for  the INTL  address.  To 
  50.  address it to point 3 of node 12 in your Net, enter 12.3...
  51.  
  52.      GenMsg  provides  for  a  Configurable "default"  ORIGIN line,  and the 
  53.  ability to configure each area differently thru use of a file named  ORIGIN 
  54.  in each message directory, which contains the origin string.
  55.  
  56.      GenMsg supports the use of UTC  message dating.   Since this  is not  a 
  57.  FidoNet  standard,  the Date  is "hidden"  behind a  CTRL-A in  the typical 
  58.  FidoNet Kludge fashion...
  59.  
  60.      GenMsg provides "Auto Formatting" of messages destined to  the Internet 
  61.  via  a  gate-way.  If  you set  up GenMsg  for using  a uucp-gate,  it will 
  62.  automatically format such messages for you.
  63.  
  64.  SETUP:
  65.      GenMsg requires that you  have a  configuration file  named GenMsg.ini.  
  66.  If you will be accessing EchoMail and/or LocalMail message areas,  you will 
  67.  also need an "areas.bbs" type list of those areas.  You will have to have a 
  68.  Text  Editor  which  can  be  called  from GenMsg,  and for  the encryption 
  69.  features you will need Pretty Good Privacy (PGP).
  70.  
  71.  GenMsg.ini:
  72.      The  configuration  file  GENMSG.INI  must  be  in  the  same directory 
  73.  GENMSG.EXE  is  in.   If  you rename  GENMSG.EXE, you  will have  to rename 
  74.  GENMSG.INI  to  match.   (example:  if GENMSG.EXE  is renamed  to GMSG.EXE, 
  75.  GENMSG.INI must be renamed GMSG.INI)
  76.  
  77.      GENMSG.INI must contain setup  information specifying  your name,  INTL 
  78.  address, the  Ascii-text Editor  to call,  and the  directory path  to your 
  79.  NetMail.  There are many other optional  parameters that  can or  should be 
  80.  set  for  your  apprication.   Refer  to  the  accompanying  GENMSG.INI for 
  81.  information on how to configure GenMsg.
  82.  
  83.  
  84.  Message Areas List:
  85.      Unless you are going to use GenMsg for your NETMAIL area only, you will 
  86.  need to have a list of other message areas GenMsg  can access.   GenMsg can 
  87.  use the "standard" AREAS.BBS, or can be configured to use another list that 
  88.  you've created.   Since the  standard AREAS.BBS  does not  normally include 
  89.  LOCAL message areas, the method of having a separate list for GenMsg to use 
  90.  is generally prefered.  The name of such file can be any legal DOS name and 
  91.  must be specified in GENMSG.INI.
  92.  
  93.      The  format  of  this  list  is  explained  more  fully  in   the  file 
  94.  MSGAREAS.BBS which has been included as an example  of how  to create  this 
  95.  list.
  96.  
  97.  
  98.  ENVIRONMENT:
  99.      GenMsg calculates the UTC date and time based  upon your  system clock, 
  100.  and expects to find the environment variable TZ  to be  set indicating  the 
  101.  time shift between your local time, and Greenwich  Mean time.   To set  the 
  102.  variable use the DOS command Set in your Autoexec.bat file as:
  103.  
  104.  SET TZ=EST5      (Eastern Standard time)
  105.  SET TZ=EST5EDT   (Eastern Daylight savings time)
  106.  
  107.      The first three alpha characters should  be the  abbreviation for  your 
  108.  standard time zone. the (next) single digit should be the  offset in  hours 
  109.  from Greenwich Mean time for your standard time  zone.  If  Daylight Saving 
  110.  time  is  observed  in  your  area,  you should  add the  last three  alpha 
  111.  characters,  which  automatically  compensate  for  daylight  savings  when 
  112.  appropiate for calculating UTC...
  113.  
  114.  
  115.      You SHOULD also have the PGP environment variable  PGPPATH=pgpstuff set 
  116.  for PGP to act properly.  Refer to the PGP Docs for this information!
  117.  
  118.  
  119.  SETUP of PGP PASS-PHRASE:
  120.      GenMsg provides for the installation of your pass-phrase to enhance the 
  121.  ease of use of PGP.  When installed, GenMsg secures the  pass-phrase in  an 
  122.  encrypted form inside of the GenMsg.EXE file.  It will then decrypt it, and 
  123.  pass it to PGP when it calls PGP, upon return from PGP the decrypted  pass- 
  124.  phrase is distroyed.  GenMsg will only accept your pass-phrase for  storage 
  125.  if it can obtain the required information from your system that it needs to 
  126.  store  it  in a  secure manner.   Not all  systems will  have the  required 
  127.  information available -  thus this option may not be available to all Users 
  128.  of GenMsg.
  129.  
  130.      GenMsg provides yet another degree of security for the USE of the pass- 
  131.  phrase.  When installing the  pass-phrase you  will be  asked for  a GenMsg 
  132.  password.  This password should not be  the same  as your  PGP pass-phrase.  
  133.  The GenMsg password can be a phrase (include spaces, etc.)  and it  must be 
  134.  at least four but not exceeding 79 characters in length.
  135.  
  136.      Once  the  pass-phrase  is  installed  GenMsg  will  check  the  system 
  137.  information each time it is envoked, if it doesn't match the information it 
  138.  has stored, it will immediatly distroy the copy of the pass-phrase and  the 
  139.  GenMsg password it contains  to keep  it secure.   GenMsg will  distroy the 
  140.  stored  pass-phrase  and GenMsg  password if  the GenMsg.EXE  is copied  to 
  141.  another Disk and envoked, or if envoked on another system.
  142.  
  143.      To  install  your  pass-phrase  envoke  GenMsg  with  the  command-line 
  144.  argument "SET" (i/e GenMsg SET). GenMsg will ask  you for  your pass-phrase 
  145.  and if it can obtain all  of the  system information  it requires,  it will 
  146.  store the pass-phrase.  If you do not enter anything when prompted to enter 
  147.  your  pass-phrase,  GenMsg  will  delete  any  pass-phrase  it  might  have 
  148.  previously contained.  (a useful  way to  insure that  your pass-phrase  is 
  149.  erased from any copies of GenMsg  you may  copy for  a friend)  Once setup, 
  150.  GenMsg will keep the pass-phrase for use until you change  it, or  any part 
  151.  of the system information it monitors changes causing GenMsg to distroy the 
  152.  pass-phrase.
  153.  
  154.      When envoking GenMsg, the use of the stored pass-phrase is DISABLED for 
  155.  security reasons.  To ENABLE it you must use  the command  CTRL-P from  the 
  156.  main  (message  view)  menu.   When enabling  the pass-phrase  you will  be 
  157.  required to enter the GenMsg password.  The CTRL-P command is a toggle,  so 
  158.  subsequent use of it will disable the use of the pass-phrase.
  159.  
  160.  ORIGIN:
  161.      GenMsg will use the string you setup in  GENMSG.INI as  the ORIGIN  for 
  162.  messages you create (NOT  NetMail messages)  unless it  finds a  file named 
  163.  ORIGIN in the message directory.  This feature provides the ability for you 
  164.  to customize the origin line you use for each Echo message area.   The file 
  165.  ORIGIN is an Ascii-Text file with  one string  in it.   The string  will be 
  166.  trunicated if it is too long... Origin lines must not exceed 79 characters, 
  167.  including your INTL address.
  168.  
  169.  D'Bridge:
  170.      GenMsg can fit in with D'Bridge nicely.  To  use it  with D'Bridge  you 
  171.  must enable  D'Bridge mode  in your  GENMSG.INI, and  have the  ENVIRONMENT 
  172.  variable of DB=path_to_DBridge or DBRIDGE=path_to_DBridge set.
  173.  
  174.      GenMsg can function as a replacement for the D'Bridge Internal  Editor.  
  175.  Refer  to  the  accompanying  DBRIDGE.TXT  file  for  further   information 
  176.  concerning setup.
  177.  
  178.  
  179.  
  180.  PGP USE:
  181.       GenMsg (if setup to emplement this feature) will call PGP  to Encrypt, 
  182.  Ascii-Armor Sign, Clear-Text Sign, or Decrypt a message.  Assuming you Have 
  183.  PGP setup properly, and enabled in GenMsg...
  184.  
  185.  Decode Function:
  186.       This function will call PGP to decode the message-text of  the message 
  187.  you are viewing.  If the text contains a Public Key,  PGP will  process it, 
  188.  and allow you to add it to your Key-Ring.  If  the text  contains a  Signed 
  189.  Public Key (some people  do this???   !!!) The  first Decode  Function will 
  190.  remove the Clear-Text Signature,  envoking the  Decode Function  again will 
  191.  allow PGP access to the Public Key...
  192.  
  193.       Note that when decoding a signed  message, PGP  will alert  you if  it 
  194.  fails  the  verification process...   other-wise the  message will  just be 
  195.  stripped of the signature.
  196.  
  197.  Encrypt Function:
  198.       PGP provides  for the  ability to  encrypt for  multiple recipients... 
  199.  GenMsg uses  this ability  to allow  you the  ability to  Decode a  message 
  200.  you've  encrypted  to someone  else, by  encrypting it  for the  designated 
  201.  person(s) AND yourself.  This feature allows  you to  re-edit a  message if 
  202.  you need to.
  203.       When GenMsg passes the  "encrypt-to" name  to PGP,  it is  enclosed in 
  204.  quotation marks (" ").  If you wish to encrypt for multiple recipients, you 
  205.  MUST enter their names (when GenMsg asks for this info) in this manner:
  206.  
  207.  first name" "second name" "third name","etc...
  208.  
  209.      NOTE that the begining and ending quotation marks are NOT  added!  Each 
  210.  name is separated by  quotation marks  separated by  a space.   This string 
  211.  cannot exceed 256 charaters in length.
  212.  
  213.  Signing Messages:
  214.       GenMsg can call PGP to sign a message in one of two  modes: Clear-Text 
  215.  Mode, and Ascii-Armor Mode.
  216.  
  217.       Clear-Text mode is the most used, as the  text of  the message  can be 
  218.  read without the use of PGP.  Calling PGP to Decode a Clear-Text message is 
  219.  done to VERIFY that the message-text has not been altered,  and was  signed 
  220.  by the person who owns the Public Key used for verification.
  221.  
  222.       Ascii-Armor  signatures  appear to  be encrypted,  and cannot  be read 
  223.  without proccessing them with PGP.  Altho they appear to be encrypted, they 
  224.  are not... anyone using PGP can process it for viewing, the Decode function 
  225.  verifies that the text has not been altered, and that it was signed by  the 
  226.  person owning the Public Key used for verification.
  227.  
  228.      Bogus "signed" messages are not processed by PGP.  They are  similar in 
  229.  appearance to a PGP clear-signed message but are truely bogus...
  230.  
  231.  
  232.  PLEASE NOTICE THIS!
  233.  
  234.       GenMsg would not be what it is, were it not for the input received  by 
  235.  those  who   are  thoughtful   enough  to   provide  suggestions   for  its 
  236.  improvement...  I appreciate ALL who have assisted in this manner.
  237.  
  238.       Special thanks are due to those who not only provided suggestions, but 
  239.  incentive, encouragement, and other  types of  assistance... without  which 
  240.  GenMsg would have stopped progressing long  ago. (I  personally don't  mind 
  241.  programs without "glit 'an  glitter" features...   ) Those  who have  had a 
  242.  significant impact upon GenMsg include:
  243.  
  244.  - Christopher Baker at 1:374/14
  245.  - Barry Kapke at 1:125/33
  246.  
  247.       And last  but not  least, Tom  Jennings... without  whom none  of this 
  248.  would have ever been necessary...
  249.  
  250.                                      -gk
  251.  
  252. For additional information contact:
  253.      GK Pace
  254.      4590 Dixie Way
  255.      Mims, Florida USA 32754
  256.      (407)269-3088
  257.      1:374/26 @ FidoNet
  258.      gkp@f26.n374.z1.fidonet.org
  259.